lib-tmp is designed for use when an application (or library) is in concurrent
development with a library on which it depends.

The in-development library can be copied here from an external project and
linked against, thus testing the inter-action of new application and new
library.

Each library should have it's own directory under lib-tmp and all the libtool
files should be copied there including the hidden .libs directory. The resulting
directory structure can be seen at the bottom of this document.

N.B.
----
To be able to LINK against this temporary library, the AutoMake file must have
the following line:-

xxxxxxxxx_LDADD = $(tmplibraries)

The variable tmplibraries contains all temporary libraries found by the search
routine in configure.ac. N.B. configure.ac provides a single variable so all
Makefile.am's which consume it must be at the same level in the folder
hierarchy, e.g.:-
source/progs/c/src/libmgec/Makefile.am
and
source/progs/c/src/test-bstree/Makefile.am.

N.B.
----
The xxxxxxxxx_LDFLAGS assignment in the Makefile.am is no longer used as it does
not necessarily set the search path variable LD_LIBRARY_PATH in the desired
order, the standard location may precede our temporary library location in the
search path.

================================================================================
The resulting lib-tmp directory would look like this:-

lib-tmp:
total 12
drwxrwxr-x 3 mgrantprg mgrantprg 4096 May 29 15:13 .
drwxrwxr-x 8 mgrantprg mgrantprg 4096 May 29 15:24 ..
drwxrwxr-x 5 mgrantprg mgrantprg 4096 May 29 15:23 libswocserver
-rw-rw-r-- 1 mgrantprg mgrantprg    0 May 29 15:13 lib-tmp usage.txt

lib-tmp/libswocserver:
total 32
drwxrwxr-x 5 mgrantprg mgrantprg 4096 May 29 15:23 .
drwxrwxr-x 3 mgrantprg mgrantprg 4096 May 29 15:13 ..
drwxrwxr-x 2 mgrantprg mgrantprg 4096 May 29 15:23 .deps
drwxrwxr-x 2 mgrantprg mgrantprg 4096 May 29 15:23 .libs
-rw-rw-r-- 1 mgrantprg mgrantprg 1098 May 29 15:20 libswocserver.la
-rw-rw-r-- 1 mgrantprg mgrantprg  341 May 29 15:20 libswocserver_la-version.lo
-rw-rw-r-- 1 mgrantprg mgrantprg 2456 May 29 15:20 libswocserver_la-version.o
drwxrwxr-x 4 mgrantprg mgrantprg 4096 May 29 15:23 swocserver

lib-tmp/libswocserver/.deps:
total 12
drwxrwxr-x 2 mgrantprg mgrantprg 4096 May 29 15:23 .
drwxrwxr-x 5 mgrantprg mgrantprg 4096 May 29 15:23 ..
-rw-rw-r-- 1 mgrantprg mgrantprg 3592 May 29 15:20 libswocserver_la-version.Plo

lib-tmp/libswocserver/.libs:
total 52
drwxrwxr-x 2 mgrantprg mgrantprg  4096 May 29 15:23 .
drwxrwxr-x 5 mgrantprg mgrantprg  4096 May 29 15:23 ..
-rw-rw-r-- 1 mgrantprg mgrantprg 14842 May 29 15:20 libswocserver.a
lrwxrwxrwx 1 mgrantprg mgrantprg    19 May 29 15:23 libswocserver.la -> ../libswocserver.la
-rw-rw-r-- 1 mgrantprg mgrantprg  1099 May 29 15:20 libswocserver.lai
-rw-rw-r-- 1 mgrantprg mgrantprg  2680 May 29 15:20 libswocserver_la-version.o
lrwxrwxrwx 1 mgrantprg mgrantprg    22 May 29 15:23 libswocserver.so -> libswocserver.so.1.0.0
lrwxrwxrwx 1 mgrantprg mgrantprg    22 May 29 15:23 libswocserver.so.1 -> libswocserver.so.1.0.0
-rwxrwxr-x 1 mgrantprg mgrantprg 17912 May 29 15:20 libswocserver.so.1.0.0

lib-tmp/libswocserver/swocserver:
total 40
drwxrwxr-x 4 mgrantprg mgrantprg 4096 May 29 15:23 .
drwxrwxr-x 5 mgrantprg mgrantprg 4096 May 29 15:23 ..
drwxrwxr-x 2 mgrantprg mgrantprg 4096 May 29 15:23 .deps
-rw-rw-r-- 1 mgrantprg mgrantprg    0 May 29 15:20 .dirstamp
drwxrwxr-x 2 mgrantprg mgrantprg 4096 May 29 15:23 .libs
-rw-rw-r-- 1 mgrantprg mgrantprg  361 May 29 15:20 libswocserver_la-optionproc.lo
-rw-rw-r-- 1 mgrantprg mgrantprg 6824 May 29 15:20 libswocserver_la-optionproc.o
-rw-rw-r-- 1 mgrantprg mgrantprg  373 May 29 15:20 libswocserver_la-validateconfig.lo
-rw-rw-r-- 1 mgrantprg mgrantprg 4848 May 29 15:20 libswocserver_la-validateconfig.o

lib-tmp/libswocserver/swocserver/.deps:
total 24
drwxrwxr-x 2 mgrantprg mgrantprg 4096 May 29 15:23 .
drwxrwxr-x 4 mgrantprg mgrantprg 4096 May 29 15:23 ..
-rw-rw-r-- 1 mgrantprg mgrantprg    0 May 29 15:20 .dirstamp
-rw-rw-r-- 1 mgrantprg mgrantprg 5943 May 29 15:20 libswocserver_la-optionproc.Plo
-rw-rw-r-- 1 mgrantprg mgrantprg 5646 May 29 15:20 libswocserver_la-validateconfig.Plo

lib-tmp/libswocserver/swocserver/.libs:
total 24
drwxrwxr-x 2 mgrantprg mgrantprg 4096 May 29 15:23 .
drwxrwxr-x 4 mgrantprg mgrantprg 4096 May 29 15:23 ..
-rw-rw-r-- 1 mgrantprg mgrantprg 7424 May 29 15:20 libswocserver_la-optionproc.o
-rw-rw-r-- 1 mgrantprg mgrantprg 5144 May 29 15:20 libswocserver_la-validateconfig.o
